home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994…tember: Reference Library / Dev.CD Sep 94.toast / Technical Documentation / PCI Information / PCI Developer’s Kit (disk) / Open Firmware / Tokenizer / Tokenizer ReadMe next >
Encoding:
Text File  |  1994-06-27  |  1.5 KB  |  51 lines  |  [TEXT/MPS ]
  1. The tokenizer is implemented as a CForth-93 dictionary.  To use the tokenizer,
  2. execute the CForth-93 tool, specifying the dictionary as follows:
  3.  
  4.     CForth93 tokenizer.dic
  5.  
  6. This will load the CForth93 tool, which will, in turn, load the tokenizer's dictionary.
  7. At this point, the tokenizer is awaiting a command.  (Unfortunately, due to the cruddy
  8. manner in which terminal I/O is simulated in MPW, no prompt is supplied.  The flashing
  9. cursor is the only indication that the tokenizer is waiting.)
  10.  
  11. To tokenize a file, type:
  12.  
  13.     tokenize <filename>
  14.  
  15. This will start tokenizing the top-level file.  Within this file, a tokenizer FLOAD
  16. command can be used to include other files.  This command looks like:
  17.  
  18.     fload <filename>
  19.  
  20. FLOADs can be nested.
  21.  
  22. The tokenizer builds the FCode image into an internal buffer.  After all the source
  23. has been tokenized, the image is saved by using the save-image command as:
  24.  
  25.     save-image <filename>
  26.  
  27. Then, type
  28.  
  29.     bye
  30.  
  31. to exit CForth93.
  32.  
  33. In addition to the standard Open Firmware words, two additional words have been added
  34. to make it easier to produce PCI Expansion ROM images.  These are:
  35.  
  36.     pci-header
  37.     pci-end
  38.  
  39. They should bracket the normal Open Firmware code.  The pci-header command will generate
  40. a PCI image header first.  So, a complete FCode image will be generated by:
  41.  
  42.     pci-header                \ generate proper PCI image header
  43.         version1            \ generate proper FCode header (within PCI image)
  44.         ...
  45.         ...
  46.         end0                \ terminate normal FCode
  47.     pci-end                    \ complete the PCI image
  48.  
  49.  
  50.  
  51.